home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / deen095.zip / DEEN.DOC next >
Text File  |  1992-03-03  |  11KB  |  281 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. D E E N    0.95   Echomail Message Encoder/Decoder
  8.  
  9. (C) 1992 Rubens Rahim
  10.  
  11.  
  12. Legal: Use this program entirely at your own risk!
  13.        I will not be held responsible for ANYTHING that
  14.        happens through the use of this program. If you do
  15.        not agree to the above, DO NOT USE THIS!
  16.  
  17. Note:It is assumed that the reader possesses some knowledge on
  18.      DOS, Echomail, and BBS systems.
  19.  
  20. Introduction:
  21. -------------
  22. DEEN is a message decoder/encoder for echomail systems. It permits two
  23. or more users to send private encoded echomail between each other over
  24. public echomail networks. MAKE SURE YOU HAVE THE MODERATOR'S PERMISSION
  25. BEFORE DOING THIS!!!!. This is especially useful for QWK based networks
  26. where there is no real way to send private mail.
  27.  
  28. The encoded messages will stay within low-ASCII (32-127) and will not
  29. affect any echomail processors. DEEN utilizes a KEY file system. Users
  30. who want to send messages between each other must possess the same KEY
  31. file. A utility to generate KEY files (KEYGEN.EXE) has been included.
  32. More than 9.9 x 10^99 different KEY file combinations are possible.
  33. A DIFFERENT KEYfile will be generated each time KEYGEN is run. Users
  34. without the correct KEY file will NOT be able to decode messages,
  35. even if they possess DEEN. Thus, DEEN can be used simultaneously among any
  36. number of different users with no possibility of a security breach.
  37.  
  38. Instructions:
  39. -------------
  40. First, you should generate a KEY file. If someone else whom you want to
  41. communicate with has already done so for you, obtain the KEY file from
  42. him/her and skip this section.
  43.  
  44. To generate a KEY file, simply type
  45.  
  46. KEYGEN <keyfile>
  47.  
  48. where <keyfile> is a standard 8 character DOS filename. DO NOT USE
  49. AN EXTENSION.  .KEY will automatically be used. Give the keyfile
  50. a name such that it will not be confused with other KEYfiles.
  51. (e.g. if the KEY file is to be used for two people called Jack and Jill,
  52. a name like JAK-JIL.KEY would be appropriate.)The KEY file will
  53. be 7600 bytes long.
  54.  
  55. Once you've generated your KEY file, give everyone whom you want to
  56. communicate privately with a copy of it. DO NOT GIVE IT TO ANYONE ELSE!!!!
  57. Any number of KEY files can be generated, as long as they have
  58. different filenames. You should generate as many KEY files as
  59. you require.(Generally one for each individual or group of
  60. individuals you want to communicate privately with.)
  61.  
  62. To send an encoded message:
  63. ---------------------------
  64. This involves three processes: Typing the message, encoding the message,
  65. and importing or inserting the encoded text into an echomail message.
  66. First, type your message on a standard ASCII text editor. (e.g. Qedit,
  67. DOS' EDIT, etc) MAKE SURE your text does not go to far to the right
  68. (i.e. more than 80 columns wide) This will mess DEEN as well as your
  69. BBS message editor up! Just to be sure, I would suggest keeping your
  70. message within 70 columns. When you import your message, your BBS editor
  71. must NOT have to word-wrap any line because it line is too long! Keep your
  72. lines within the allowable width of your BBS editor. This is VERY, VERY
  73. important! The message can be as many lines as you want, but it
  74. MUST NOT contain any high-ASCII (Ansi graphics or anything above chr(127)).
  75. This is to conform to FidoNET standards which do NOT allow high-ASCII!
  76. Save the message to a disk file.
  77.  
  78. Next, type
  79.  
  80. DEEN <keyfile> encode <infile> <outfile>
  81.  
  82. <keyfile> is the name of the Keyfile you just created or were given.
  83. Do NOT specify an extension! (e.g. JAK-JIL or JIM-DAVE)
  84.  
  85. 'encode' can be abbreviated to 'e' if you feel like it....
  86.  
  87. <infile> is the ASCII text file you just typed. If you had an extension,
  88. you must include that here too. Paths are fine. (e.g. LETTER1.TXT, etc...)
  89.  
  90. <outfile> is the encoded ASCII text file. It can be any legal 8+3 DOS
  91. character filename. (e.g. LETTER1.DEC, OUT2, \BBS\MSG\MSG20.MDE, etc..)
  92.  
  93. DEEN will display the encoding process on the screen. It is fast!
  94. Your encoded <outfile> will be created.
  95.  
  96. DEEN will NOT encode the message if any line is more than 80
  97. columns long and/or any high-ASCII characters exist. A BEEP and an
  98. error message will let you know if this happens. Fix it and simply
  99. restart the process.
  100.  
  101. Logon to the BBS. Select 'Enter a message' or equivalent. Enter
  102. the 'To:', 'From:' and 'Subject:' like any ordinary message.
  103. Import or insert the encoded <outfile> into the BBS
  104. message editor as if you were importing a regular ASCII text file into
  105. a message. Save the message and make sure it is sent like any other
  106. echomail message. Your BBS manual should have more information on this.
  107.  
  108. Example: Your original file <infile>
  109. -----------------------------------------------------------------
  110. Dear Helmut,
  111.  
  112. Thank you for your E-mail. I've just obtained this program called DEEN.
  113. I think it is excellent. It now allows me to send private mail via
  114. echomail at no extra cost. I just have to get you set up. Give me
  115. your FidoNET address and I'll FSEND my KEY file to you.
  116.  
  117. Best regards.....Wolfgang
  118. ------------------------------------------------------------------
  119.  
  120. DEEN will create <outfile> that looks like this:
  121. -------------------------------------------------------------------
  122. qf<~I 6&SOs-
  123.  
  124. }4<0x#CGwb/PzF_il??I^:c?oAt,g<>s %isSi>ZL+VY@FM0z[_ n;s"!-+B#qk9P6'?B}~
  125. 5oj^OzIi)i!Y?FLNc$62- r*B{gNVr<s.TOgpN'%eBPo?<+{Q&Oc|+;cBU};FqCBf)
  126. c!}(/UE&>ysSk#yHCRzrvjd,TAt,Xjoe@ySxO:'ZTBnY|F1Sx&(UxD}:DUzO=RCTj
  127. yIg~I_E{r@Jk#dQ(D$E8vF[KB{>\89da]rc~-Y'z(F1aO|+8pl_(M|_
  128.  
  129. ]f85Is69k|fG}v4'Y[W2lBc$:
  130. -----------------------------------------------------------------------
  131.  
  132. As you can see, the encoded <outfile> consists only of regular keyboard
  133. characters, maintaining the no-high-ASCII standard.
  134.  
  135. That's it! If you've done everything right, the other party should
  136. receive and be able to decode your message.
  137.  
  138. To receive an encoded message:
  139. ------------------------------
  140.  
  141. Export the message to disk. (Get the message into a text file) Your BBS
  142. manual will show you if you don't know how.
  143.  
  144. Make sure that the exported file has no extraneous text on the left or right.
  145. Extra lines above and below the message are O.K. For example:
  146.  
  147. ------------------------------------------------------------
  148. To:   Helmut Schmidt                           26 Feb 1992
  149. From: Wolfgang Mauer                           Msg 21/3992
  150. Subj: Encoded Message..             Germany Chit-Chat Echo
  151.  
  152. qf<~I 6&SOs-
  153.  
  154. }4<0x#CGwb/PzF_il??I^:c?oAt,g<>s %isSi>ZL+VY@FM0z[_ n;s"!-+B#qk9P6'?B}~
  155. 5oj^OzIi)i!Y?FLNc$62- r*B{gNVr<s.TOgpN'%eBPo?<+{Q&Oc|+;cBU};FqCBf)
  156. c!}(/UE&>ysSk#yHCRzrvjd,TAt,Xjoe@ySxO:'ZTBnY|F1Sx&(UxD}:DUzO=RCTj
  157. yIg~I_E{r@Jk#dQ(D$E8vF[KB{>\89da]rc~-Y'z(F1aO|+8pl_(M|_
  158.  
  159. ]f85Is69k|fG}v4'Y[W2lBc$:
  160. ---
  161.  * Origin: Ich liebe Deutschland, Baden-W (3:321/223)
  162.  -------------------------------------------------------------
  163.  
  164. The above is O.K. The actual encoded text is still intact.
  165. (i.e. from left to right). The one below is NOT ok! because there are
  166. line numbers on the left!
  167.  
  168. -----------------------------------------------------------
  169. To:   Helmut Schmidt                           26 Feb 1992
  170. From: Wolfgang Mauer                           Msg 21/3992
  171. Subj: Encoded Message..             Germany Chit-Chat Echo
  172.  
  173. 1:qf<~I 6&SOs-
  174. 2:
  175. 3:}4<0x#CGwb/PzF_il??I^:c?oAt,g<>s %isSi>ZL+VY@FM0z[_ n;s"!-+B#qk9P6'?B}~
  176. 4:5oj^OzIi)i!Y?FLNc$62- r*B{gNVr<s.TOgpN'%eBPo?<+{Q&Oc|+;cBU};FqCBf)
  177. 5:c!}(/UE&>ysSk#yHCRzrvjd,TAt,Xjoe@ySxO:'ZTBnY|F1Sx&(UxD}:DUzO=RCTj
  178. 6:yIg~I_E{r@Jk#dQ(D$E8vF[KB{>\89da]rc~-Y'z(F1aO|+8pl_(M|_
  179. 7:
  180. 8:]f85Is69k|fG}v4'Y[W2lBc$:
  181. ---
  182.  * Origin: Ich liebe Deutschland, Baden-W (3:321/223)
  183. ----------------------------------------------------------------
  184.  
  185. If you BBS software insists on putting text on the left or right
  186. of the actual message text, the only way to make things work is to
  187. go into a text editor and remove them yourself!
  188.  
  189. Once you have the message exported to a text file, exit to DOS and
  190. type:
  191.  
  192. DEEN <keyfile> decode <textfile>
  193.  
  194. <keyfile> is the .KEY file. This MUST be the same one that was used
  195. to encode the message.
  196.  
  197. 'decode' can be abbreviated to 'd' if you feel like it.
  198.  
  199. <textfile> is the filename of the exported message text that you
  200. obtained from the encoded echomail message (see above). DEEN will
  201. output something like this:
  202.  
  203. DEEN 0.95 Message Encoder/Decoder (C)1992 Rubens Rahim
  204.  
  205. To:   Helmut Schmidt                           26 Feb 1992
  206. From: Wolfgang Mauer                           Msg 21/3992
  207. Subj: Encoded Message..             Germany Chit-Chat Echo
  208.  
  209. Dear Helmut,
  210.  
  211. Thank you for your E-mail. I've just obtained this program called DEEN.
  212. I think it is excellent. It now allows me to send private mail via
  213. echomail at no extra cost. I just have to get you set up. Give me
  214. your FidoNET address and I'll FSEND my KEY file to you.
  215.  
  216. Best regards.....Wolfgang
  217.  
  218. ---
  219.  * Origin: Ich liebe Deutschland, Baden-W (3:321/223)
  220.  
  221.  
  222.  
  223. As you can see, the message has been decoded. If you get an error
  224. saying "Nothing found to decode", it probably means that spaces
  225. or some other extraneous characters have been inserted on the left.
  226. If you get the header ok (i.e. To: From:,etc) but a totally garbled
  227. message, it probably means that your are using the wrong KEY.
  228. Get the right KEYfile from the sender of the message. If you get the
  229. message o.k. but garbled text on the right, it probably means that
  230. spaces or other extraneous characters have been inserted on the right.
  231.  
  232. Final Note:
  233. -----------
  234.  
  235. It is VERY important that you do not release any of your original
  236. non-encoded message text files! Only the encoded version should be
  237. sent via echomail. Releasing both the non-encoded and the encoded
  238. version of any message will seriously undermine the security of
  239. any other messages sent with the same KEYfile!!!! This should not
  240. be a problem at all unless you give everyone you meet full access
  241. to your hard disk! Obviously, you should not release your KEYfiles
  242. publicly either! However, sending and receiving more than 1 message with
  243. the same KEYfile is perfectly 100% safe! DEEN was designed for that.
  244. Don't get paranoid! Keep your KEYfiles and original, non-encoded
  245. messages safe, and you should be fine. The only thing that the general
  246. public should be able to see is the encoded (garbled) message sent via
  247. echomail. Nothing else. This should be quite obvious!
  248.  
  249.  
  250. That's it! I've tested it, and it works for me. If it doesn't work for
  251. you, I'd like to hear about it. I will try to help you. All comments,
  252. criticisms, suggestions, pleas for help, bug reports (nah!...no way),
  253. reports on grammatical errors in DOCs, etc can be sent to me via:
  254.  
  255. Snail Mail:
  256.  
  257. Rubens Rahim
  258. 4082 Virginia Cres.
  259. North Vancouver, BC
  260. Canada V7R 3Z1
  261.  
  262. Fidonet: Rubens Rahim 1:153/749 (can also be accessed via UUCP systems)
  263.  
  264. Fax: 1 (604) 980-7396
  265.  
  266. Voice: Not unless you know me personally!
  267.  
  268. BBS: 1 (604) 980-9078
  269.  
  270. I would especially like to hear from you if you have figured out a way
  271. of decoding someone else's messages without possessing the key or any of
  272. the original unencoded messages used with the key. I think it is
  273. impossible. I may be wrong......
  274.  
  275. DEEN is public domain. You don't have to pay a cent for it. However,
  276. if you're very rich and feel generous, you can send me any amount
  277. you want through the above snail-mail address.
  278.  
  279. That's all.......Enjoy!
  280.  
  281.